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Introduction 


GDDME.EXE emulates the IBM Graphical Data Display Manager program product (GDDM) and the VS 
APL AP126 auxiliary processor. GDDM Emulator (GDDME) is meant to be used with Dyalog APL for MS 
Windows by Dyadic Systems Ltd. 


GDDME is a DDE client application and communicates with Dyalog APL/W via one shared variable. 
Generally, input and output data formats match to appropriate data formats used in AP126 and GDDM. This 
document describes the differences between GDDM and GDDME. When GDDME is running, on-line help is 
available through the system menu. Hard copy of GDDME window contents can be produced via GDDM 
requests or via the system menu of the GDDME window. 


GDDME requires that the font named "MS-DOS CP 437" be installed in MS Windows. From the MS 
Windows Control Panel, open the Fonts window. If the font "MS-DOS CP 437" is not included in the list of 
installed fonts, do the following to install it: 


1. Click on the Add button to open the window to add fonts. 

2. Select the \windows\system directory to display MS Windows system fonts. 
3. Select the MS-DOS CP 437 font from the list of fonts. 

4. Click on the OK button. 

5. Close the fonts window. 


GDDME is program product by Lingo Allegro USA, Inc. 
The following (or equivalent) manuals should be used during GDDME programming: 


1. Graphical Data Display Manager, Programming Reference, Third Edition, International Business 
Machines Corp., 1983. 


2. VS APL for TSO: Terminal User's Guide, Release 4, International Business Machines Corp., 1983. 
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1. GDDME.EXE command string format 


Before you start the GDDME program, the APL/W system must be prepared to share a control variable (see 
section 2). 


You may run the GDDME.EXE program either from an APL/W session or from the Windows File Manager. 
Normally, you should include at least two parameters in the command string which runs GDDME. These 
parameters are separated with blanks, and each parameter begins with "-". You may include up to four 
additional startup parameters which set GDDME defaults. The general format is as follows: 


GDDME.EXE -wsid -extname r=rows c=cols f=font b=scheme 


where: 

wsid  - server name: the name of the APL/W workspace (may include a path) in which the control shared 
variable is defined; if you execute this command string in an APL/W session, this parameter is the 
current value of ÜWSID; if this parameter omitted, the string "SERVER" will be used; 

extname - the external name of the shared variable (see next section for details); if this parameter omitted the 
string "EXTNAME" will be used; 

rows - integer between 2 and 64 that specifies the default number of character lines in the GDDME 
window, if this parameter omitted, 25 lines will be used; 

cols - integer between 2 and 132 that specifies the default number of character columns in the GDDME 
window; if this parameter omitted, 80 columns will be used; 

font - integer between 0 and 9 that specifies the default font number (see the description of "-12" AP126 
call for details), this font will be used for operations with alphanumeric fields; if this parameter is 
omitted, font number 3 will be used; 

scheme - integer between 0 and 3 that specifies the color scheme that will be used in the GDDME window 
(see the description of "-11" AP126 call); if this parameter omitted, scheme number 0 will be 
used. 


If only one of the first two parameters is present, it is treated as the server name. The r, c, f, and b parameters 
can be specified in arbitrary order in the command line. Any (or even all) of them can be omitted. For 
example, the following command starts GDDME.EXE for the APL/W workspace WDYALOG\WS\GDDM 
and external varialble CTLs and creates a default window 32 by 80 characters using font 5; light gray 
background will be used (default color scheme): 


GDDME .EXE -WDYALOG\WS\GDDM -CTLs r=32 f=5 


The best way to start GDDME.EXE is to use the CMD system function from an APL session (see section 2). 
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2. Connecting GDDME with Dyalog APL/W 


You use three steps to connect APL/W with the GDDME program. The first step is to make a general offer to 
share a variable defined in the current workspace. The workspace must have a name. The following example 
shows how to share variable X: 


)WSID EXAMPLE 
X+(, 1) | 
'DDE:' QSVO 'X EXT! 
1 
You should assign variable X with a valid graphics command, because when the offer to share X is 
accepted by GDDME.EXE the value of X will be passed to the GDDME as the first graphics command. EXT 
in the (IS VO statement is the external name for X. You may use any valid name. This name will be displayed 
in the caption of the GDDME window. 
The next step is to start GDDME.EXE from an APL/W session or from the Windows File Manager. The 
best way is to execute the following APL expression: 


OCMD (path,'GDDME.EXE -EXAMPLE -EXT') '' 


where pat A is a path to the directory that contains GDDME.EXE. 
The generalized method for running GDDME from your current workspace is as follows (using 
UWSID in the expression causes it to adapt automatically to any change in workspace name): 


PATH+'C:\WDYALOG\GRAPHICS\' 
EXTN+' EXT! 
OCMD (PATH,'GDDME.EXE -',QWSID,' -',EXTN) '' 


PATH -isa global variable that contains the path to GDDME.EXE. Having such a variable allows 
you to easily adapt your program to a different directory location for the executable file: 
EXTN -isthe global variable that contains the external name of the shared variable. 


The third step is to wait until the connection is established. It may take several seconds depending on the 
load on your Windows system. The wait is necessary because otherwise you may loose some of the first 
graphics commands. Before the connection is established, there is no shared variable synchronization. You 
can be sure that all of your graphics commands are passed and executed by GDDME only when the value of 
(USVS 'X')[2] is 1. The following expression provides the necessary delay: 


Cn] +(127(OSVS 'X')[2])/QLc 


This expression will be executed until GDDME sets the returned value of the shared variable. This means 
that the offer was accepted and GDDME is ready to execute commands from APL. Then the user must set the 
shared variable control vector to 1 1 1 1 (full interlock). The defined function SHARE from workspace 
GDDME, shown below, provides all necessary steps for linking APL/W and GDDME via shared variable X: 


SHARE :A 

a Exit if already shared 

>(2=[]5V0 'X')/0 

a Be sure that variable is not in use 
AOSVR 'X'! 

a Set initial value 

Xe) TA 

a Issue offer to share 

A+'DDE:" (SVO 'X EXT! 

a Load GDDME 

OCMD (PATH,'GDDME.EXE -',QWSID,' -EXT') '! 
a Wait while it’s loaded 

+(12CUSVS 'X')[2])/OILC 

a Set full interlock 

A+ 1 OSVC 'X! 

a Get returned value 

A+«X 


MY NEVNE O tt) VU bu Lu toa bd bed bad 


EA EA EA FA PA TI I PA PA TI AA ÅÅ men nara rana 
ty Ed td td td td dd 


PPPRPRPRP RP wO@MNO® u 
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3. GDDME input data format 


Any value placed into shared variable X (see section 2) will be passed to GDDME as a request for a certain 
graphics operation. Variable X must be a nested vector with two items. The first item must be a simple vector 
of integers; the second item must be a simple character vector. These two items represent numeric and 
character (if any) parts of the graphical request. More than one request can be issued by a single 
specification of a shared variable. To issue more than one request their numeric and character parts 
should be catenated together. For example, this expression issues one FSQDEV request: 


X+(110 15) !! 
And this expression issues two requests FSQDEV and GSCHAR 
X+(110 15 524 50 200 5) "HELLO! 


combined in one transaction. 


The two items of the shared variable value correspond to the CTL and DAT shared variables used by the 
AP126 auxiliary processor. The following expression converts the GDDM input data format to the GDDME 


format: 
X+(  CTL) (, DAT) 


Important Note: 

Because GDDME and Dyalog APL/W work in the full interlock mode, you MUST refer to the shared 
variable before setting its new value. It is highly reccomended to use a special service function that provides 
the data exchange between GDDME and APL/W. An example of such a function is given on page 8 of this 
manual. You should avoid the direct use of the shared varrable in application programs. 
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4. GDDME output data format 


Each specification of a shared variable must be followed by a reference to the variable. The next transaction 
will be impossible until the return value of the shared variable (set by GDDME) is read. This requirement is 
important because GDDME and Dyalog APL/W communicate in full interlock mode to provide necessary 
synchronization. 


The new value of the shared variable returned by GDDME has the form of a two element nested vector. The 
first item is a simple integer vector, and the second a simple character vector. The two elements of the 
return value correspond to the CTI and DAT shared variables of the AP126 auxiliary processor. 


The integer vector has at least five elements and has the following format: 


hre, rc, rs, nnp, led, np 
where: 
hrc - return code for request(s). If Arc is 0 then the request(s) was successful; 1 indicates an error. If there 
was more then one request issued, Arc shows a common result for this group of requests. 


rc -return code for this request: 0 - success, 1 - error. If there was more than one request issued then each 
request will have an appropriate sequence of the four service parameters rc, rs, nnp, lcd. This format is 
equivalent to the GDDM format. However, for GDDME the user should check only the Arc parameter 
(the first number in the first item of the return value of the shared variable), because if an error took 
place GDDME returns only a 5 element vector with 1 as its first number regardless of the number of 
requests issued. 


rs -error code, if an error was detected. GDDME returns the following error codes: 
0 - not enough memory ; 
1 - array passed via the shared variable has incorrect format; 
2 - the first item of the shared variable has incorrect format; 
3 - the second item of the shared variable has incorrect format; 
4 - error in an argument of GDDME call; 
5 - unknown command (perhaps error in the number of parameters in previous call); 
6 - graphics page doesn't exist. A GDDME call was issued before the FSPCRT call was used. Only 
AP126 calls 0 and 1 can be used before the FSPCRT call. 


nnp - number of numeric parameters. Shows how many additional elements follow the led parameter. 
lcd - length of character vector (second item of returned value). 


np -numeric parameters (if any). 


The vector (hrc,rc,rs,nnp,lcd) is called the reason vector. It will be referenced, as rv below. 


The second element of the returned value is a character vector in which responses for more than one request 
can be catenated (if more than one request was issued). lcd parameters allow you to separate this vector into 
appropriate parts, if necessary. The second item of the return value will have the form of an empty vector, if 
no calls require character information from GDDME. For example: 


X+(110 4) !! 

A+X 

A 
000401 2 25 80 


This FSQDEV request has returned a 9 element integer vector as the first item of X, and an empty character 
vector as the second item of X. For consistency and convenience it is highly recommended to use the 
OUTPUT function from the GDDME workspace to handle GDDM calls. The GEP function from that 
workspace allows you to use command mnemonics instead of their codes. For example, the previous request 
could be issued as follows: 
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IN+(GEP 'FSQDEV'), 4 2 
OUTPUT 
IN 

O 0O 4 O 1 2 25 80 8 


(The OUTPUT function checks and deletes the first element of the first item of the returned value.) 


The following function GDDM from workspace GDDME can be used in programs which use AP126 
programming logic. This function uses two global variables CTL and DAT (as AP126 does) to issue GDDME 
requests and obtain their results into the same variables. It is assumed that X is a shared variable that supports 
GDDME transactions. The result of this function is the value of Arc: 


R+GDDM;A 
[1] a Check connection 
[2] +(2=QSVO 'X')/0K 
[3] SHARE 
[4] a Issue GDDM request 
[5] OK:X+(,CTL) (,DAT) 
[6] a Wait while request is executed 
[73 A+X 
[8] a Separate numeric and character parts of result 
[9] CTL+124 
[10] DAT+2>A 
[11] a Take highest reason code for request(s) 
[12] R-CTI[1] 
[13] CTL+1+CTL 
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5. Differences between GDDM and GDDME 


When the link between Dyalog APL/W and GDDME is established, GDDME creates the default GDDM page 
having page id 0. By default, this page will have 25 rows and 80 columns of characters. The default font is 7 
pixels wide and 12 pixels high. A user my specify other page and font sizes in the command string (see section 
1). A user can resize a GDDME window using the mouse. GDDME will automatically change and adjust the 
page and font sizes in pixels to keep the number of character lines and columns unchanged for a given page. 


The user can create other pages using the FSPCRT (30 2) request. This call creates a new page having the 
page identification number indicated as the first parameter, and the dimensions (in rows and columns) that 
were indicated as the second and the third parameters of the FSPCRT call. When a page is created, GDDME 
tries to use the current font to satisfy this request. If the font is too big, GDDME chooses the nearest font that 
would accomodate the required number of lines and columns of characters and may resize the window, if 
necessary. This font will be automatically changed if the user resizes the window using the mouse. You may 
use the system menu of the GDDM window to change the current font dimensions. The "-12" and FSPWIN 
calls allow you to change font and page sizes under program control. 


Different pages can have different sizes in character lines and columns and use different fonts for 
alphanumeric operations. When the FSPSEL call is used, GDDME restores the window's dimensions (in 
pixels and in characters), location, and the font size to the values which where defined for this page when it 
was the current page. 


The font that is used for alphanumeric operations cannot be resized unlimitedly (see the description of the "- 
12" call). The graphics font, which is used by graphics operations, is a TrueType font and can be resized 
arbitrarily. 


The current version of GDDME doesn't support the following fields attributes: 
Symbol Set - ANSI symbol set is used for all characters in every field. 
END; 
OUT, IN - NULLs and Blanks are equivalent. Any trailed blank is treated as NULL. 


GDDME doesn't support translation tables. Only the lower to upper case translation is supported (see the 
ASFTRN call description). 


Light pen fields are not supported completely. The programmer may use field type 3 as a sort of "light pen" 
field type. The mouse can be used to select such a field and to interrupt the ASREAD call (see the description 
of ASREAD call). If during the ASREAD call a user double-clicks a number between 1 and 24, located in 
any alphanumeric field on the currently visible page (this field can't have type 3), the ASREAD call returns 
with the same result as if the user pressed a function key with the corresponding number. 


Some GDDM calls are accepted, but ignored. This was done to increase compatibility with GDDM. For 
example, this version of GDDME does not support operations with graphical segments. However, all related 
calls are accepted. 


Most numeric arguments to GDDME should be integer data type. GDDME will try to convert a floating point 
number to the nearest integer, if it is supplied as an argument of a call that requires integer. GDDME will 
return error code 1 if this conversion is impossible. In the current release of GDDME only the GSCA call uses 
floating point arguments. In most cases, you will be able to make the necessary modifications in your 
mainframe code with little difficulty. For example, you may need to scale your parameters to an appropriate 
integer range. GDDME always returns an integer result. 


By default, the graphics field covers the entire page and has a logical coordinate system in which the left 
bottom corner of the graphics field has coordinates (0,0) and right top corner has coordinates (100,100). This 
is standard GDDM behavior. The graphics field can be defined anywhere on the page and can have an 
arbitrary logical coordinate system. However, for better graphics performance, it is reccommended to set a 
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logical coordinate system (world coordinates) in which one logical unit is approximately equal to one pixel. 
The dimensions of the graphics field in pixels can be obtained using the GSQPS call. You should avoid the 
situation, when you map very "wide" world coordinates onto a small physical region of the graphics field. 
Your world coordinates system (expanded to the entire GDDME window) can not be "wider" than from - 
32768 to 32767 logical units along each axis. 


GSCOL, GSQCOL, GSPAT, and GSQPAT calls use slightly different color coding in comparison with 
GDDM. This has been done to take advantage of MS Windows graphics features. The results, however, are 
similar to GDDM color handling. 


The GDDME window can have four different colours to paint its background: white, light grey, dark grey, and 
black. By default, the light gray background is used. You may change this default mode either using the 
command string option or the "-12" call. The default and neutral colors (which are equivalent, if it is not 
changed using GDDM calls) are set according to the current background color. For example, if the 
background color is white or light grey, the neutral color (number 7) will be black, and its bright version 
(number 15) will be dark grey. If the background color is dark grey or black, the neutral color will be white 
and its bright version will be light grey. See the description of the "-12" call for more details. 
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6. Alphabetical List of GDDME calls 


The following table gives the alphabetical list of supported GDDM calls. "*" means that this call differs 
from the original GDDM call. "i" means that this call is ignored (however its syntax is checked). "CTL" 
means the first item of the shared variable. "DAT" means the second item of the shared variable; "RES" 
means both first and second items of the returned value of the shared variable. "RES" refers only to values 
which follow four (or five for the first request) diagnostic elements in the numeric part of the returned value. 
If there is no value indicated in the CTL, DAT, or RES position, empty vector(s) is assumed. 








AP126 Calls 
O - No Operation 
CTL: 0 DAT: RES: 
-1 - Get Codes and Mnemonics | 
CTL =I DAT: RES: cds,mnms 
-8 - Extended ASQMOD 
CTL: -8,cnt,fids DAT: RES: Fld,tl, 21 
-11 - Set Color Scheme 
CTL: -11,scheme DAT: RES: 
-12 - Set Font 
CTL: -12, font number DAT: RES: 
® GDDM Calls 
ASCCOL CTL: 421,fid,len DAT: clrs RES: 
ASCGET CTL: 422,fid,len DAT: RES: chars 
ASCHLT CTL: 423,fid,len DAT: hlts RES: 
ASCPUT CTL: 424,fid, len DAT: chars RES: 
i ASCSS CTL: 425,fid,len DAT: string RES: 
ASDFLD CTL: 401,fid,r,c,d,w,t DAT: RES: 
ASDFLT CTL: 406,cnt,array DAT: RES: 
ASDFMT CTL: 402,n,cnt,array DAT: RES: 
ASFCLR CTL: 404,code DAT: RES: 
ASFCOL CTL: 407,fid,clr DAT: RES: 
ASFCUR CTL: 430, fid,row, col DAT: RES: 
ASFHLT CTL: 409,fid,hlt DAT: RES: 
ASFINT CTL: 411,fid,int DAT: RES: 
ASFMOD CTL: 412, fid, mod DAT: RES: 
i ASFPSS CTL: 414,fid,sid DAT: RES: 
ASFTRN CTL: 415,fid,tno DAT: RES: 
ASFTYP CTL: 416,fid,typ DAT: RES: 
i ASMODE CTL: 426,mod DAT: RES: 
ASQCOL CTL: 427,fid,len DAT: RES: chars 
ASQCUR CTL: 431,cod DAT: RES: fid,row,col 
ASQFLD CTL: 418,cod,n,cnt DAT: RES: array 
ASQHLT CTL: 428,fid,len DAT: RES: chars 
ASQMAX CTL: 419 DAT: RES: n,nmax 
ASQMOD CTL: 420,cnt DAT: RES: fid,len,len 
ASQSS CTL: 429, len DAT: RES: char 
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ASRATT CTL: 417,fids,cnt DAT: RES: array 











ASREAD CTL: 101 DAT: RES: att,val,cnt 
ASREMT CTL: 405,nfld,cnt,array DAT: RES: 
ASTYPE CTL: 111,typ DAT: RES: 
FSALRM CTL: 109 DAT: RES: 

i FSCLS CTL: 601,opt DAT: RES: 
FSCOPY CTL: 602 DAT: RES: 
FSFRCE CTL: 102 DAT: RES: 

i FSINIT CTL: 117 DAT: RES: 

i FSOPEN CTL: 604,cnt,array DAT: string RES: 
FSPCLR CTL: 301 DAT: RES: 
FSPCRT CTL: 302,pid,dp,wd,typ DAT: RES: 
FSPDEL CTL: 303,pid DAT: RES: 
FSPQRY CTL: 304,pid DAT: RES: dep,wid, typ 
FSPSEL CTL: 305,pid DAT: RES: 
FSPWIN CTL: 309,nl,n2,row,col DAT: RES: 
FSQCPG CTL: 306 DAT: RES: pid 

* FSQDEV CTL: 110,cnt DAT: RES: array 

i FSQERR CTL: 107,len DAT: RES: array 
FSQUPG CTL: 307 DAT: RES: pid 

i FSSAVE CTL: 104 DAT: name RES: 

i FSSHOW CTL: 105 DAT: name RES: 
GSARC CTL: 521, xc, yc;angle DAT: RES: 
GSAREA CTL: 522,control DAT: RES: 
GSCA CTL: 510,dx,dy DAT: RES: 
GSCB CTL: SLL wid, hot DAT: RES: 
GSCHAP CTL: 523, len DAT: string RES: 
GSCHAR CTL: 524,x,y,len DAT: string RES: 
GSCLR CPE 506 DAT: RES: 

i GSCM CTL. 31377 DAT: RES: 
GSCOL CTL: 314, DAT: RES: 

* GSCOPY CTL: 605,mode,sx,sy DAT: RES: 

1 GSCS CTL: 515,sid DAT: RES: 

* GSELPS CTL: 551,t,p,q,xs,ys,xe, ye RES: 
GSENDA CTL: 525 DAT: RES: 
GSFLD CTL: 502,x,y,dep, wid DAT: RES: 
GSLINE CTL: 526,X,y DAT: RES: 
GSLT CTL: SE6;n DAT: RES: 
GSLW CTS STN DAT: RES: 
GSMIX ETES 519 N DAT: RES: 
GSMOVE CTL: 528,x,y DAT: RES: 

* GSPAT ETL: 920,0 DAT: RES: 
GSPLNE CTL: 530,cnt,xarr,yarr DAT: RES: 
GSQCA CTE: 532 DAT: RES: dx,dy 
GSQCB CTL: 533 DAT: RES: wid,hgt 
GSQCEL CTL: 535 DAT: RES: wid,hgt 
GSQCOL CTL: 538 DAT : RES: color 
GSQCP CTL: 539 DAT : RES: X,Y 
GSQCUR CTL: 541 DAT: RES: win,xX,y 
GSQLT CTL: 542 DAT: RES: type 
GSQLW CTL: 943 DAT: RES: width 
GSQMAX CTL: 544 DAT: RES: 1,1 
GSQMIX CTL: 545 DAT: RES: mode 
GSQPAT CTL: 547 DAT: RES: pattern 
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* GSQPS 
GSQTB 
GSQVIE 
GSQWIN 
GSREAD 
GSSATS 
GSSCLS 
GSSDEL 
GSSEG 
GSSPOS 
GSVECM 
GSVIEW 
GSWIN 
i SSWRT 


+ 


pp po 


CTL: 
CTL: 
CTL: 
CTL: 
CIL: 
CTL: 
CTL: 
CTs 
CTL: 
CTL: 
GULE 
CTL: 
CIL: 
CIL: 


548 

560, len,cnt 

549 

550 

120,%,Y 
580,sid,nl,n2 
507 

508,sid 
509,sid 
582,sid,nl,n2 
531,n, vector 
504,x1,x2,yl,y2 
505,x1,x2, Yyl, y2 
214 
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DAT: 
DAT: 
DAT: 
DAT: 
DAT: 
DAT: 
DAT: 
DAT: 
DAT: 
DAT: 
DAT: 
DAT: 
DAT: 
DAT: 


string 


RES: 
RES: 
RES: 
RES: 
RES: 
RES: 
RES: 
RES: 
RES: 
RES: 
RES: 
RES: 
RES: 
RES: 


wid,hgt 

0,0,dx, dy, 0 
x1,x2,y1,y2 
x1,x2,y1,y2 
attype,X,Y 
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7. AP126 calls 


It is assumed that X is the name of the GDDME shared variable and rv is reason vector (see section 4) in 
all descriptions below. 


No Operation Format: X+(,0) '! 
Result: rv '' 

No actions take place. 

Get Codes and Mnemonics Format: X+(, 1) '! 


Result: (rv,codes) (mnemonics) 
Returned value is GDDME command codes (as the first item of returned value) and command mnemonics (as 
the second item) aligned from the right up to 8 characters. | 


Extended ASQMOD Format: X+("8,count,fid) '' 
Result: (rv,mod,tlen,ilen) '' 
count - length of f id vector; 
fid -vector of field identifiers; 
mod vector of field identifiers from fid vector that have been modified. These fields are 
returned in the same order as modified fields are returned by ASQMOD request, not 
necessary in the order specified by fid vector. This vector has length count with 
trailing, unused entries in the vector set to 0. 
tlen -is the vector of total lengths for each member of mod, in corresponding order and padded 
with zeros. 
ilen - is the vector of input lengths for each member of mod in the corresponding order and 
padded with zeros. Input lengths are calculated as total lengths minus trailing blanks at 
the ends of fields. | 
When the subset of fields is returned, the fields become no longer modified (as with ASQMOD call). 


Set Color Scheme Format: X+(7”11,snum) '' 
Result: rv '' 
snum - scheme number. It must be an integer between 0 and 3. The values of snum are 
interpreted as follows: 


0 - light grey color will be used as å background color; black will be used as 
a neutral color; 

1 - black color will be used as a background color; white will be used as a 
neutral color; 

2 - white color will be used as a background color; black will be used as a 
neutral color; 

3 - dark grey color will be used as a background color; white will be used as 


a neutral color; 
The GDDME window's background will be changed immediately during this call. The content of 
alphanumeric fields will be changed accordingly. The content of the graphics field will remain the same 
(except its background). The neutral color used in graphical operations will be changed only for future 
graphical calls. By default, scheme 0 is used. 
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Set Hardware Font Size Format: X+( 12,fnum) '' 
Result: rv ''! 
fnum - font number. It must be an integer between 0 and 9. The value of fnum selects one of the 
8 following fonts to use in operations with alphanumeric fields: 
0 - width 4 pixels; height 6 pixels; 
- width 5 pixels; height 12 pixels; 
- width 6 pixels; height 8 pixels; 
- width 7 pixels; height 12 pixels; 
- width 8 pixels; height 8 pixels; 
- width 8 pixels; height 12 pixels; 
- width 10 pixels; height 18 pixels; 
- width 12 pixels; height 16 pixels; 
- width 16 pixels; height 8 pixels; 
9 - width 16 pixels; height 12 pixels; 
If the current page cannot accommodate the currently-defined number of rows or columns using the font 
specified in this call, the nearest acceptable font will be used. GDDME will automatically resize its window, if 
necessary. 





CONN Un AUN = 
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8. GDDM calls 


It is assumed that X is the name of the GDDME shared variable and rv is the reason vector (see section 
4) in all descriptions below. 


Specify Character Colors Within a Field 
ASCCOL Format: X+(421,fid,len) clrs 
Result: rv '' 
fid -the number of field to be modified; 
len -the length of color string; 
clrs - character string that defines the new color for each character position within the field 
(starting at the top left corner of the field). Each character in clrs vector must be one 
of the following: 
blank -inherit the color set by ASFCOL (the default); . 
0 - same as blank; 


l - blue; 

2 - red; 

3 - pink; 

4 - green; 

5 - turquoise; 
6 - yellow; 


7 - neutral (see description of "-11" call); 
The field will be changed in the GDDME window during next ASREAD call. FSFRCE request can be used 
to make changes visible immediately. 


Get Field Contents 
ASCGET Format: X+(422,fid,len) '"! 
Result: rv chrs 
fid -the number of the field containing the required characters; 
len - the number of characters to be returned; this number of characters will be returned 
regardless of the size of the field; 
shrs -character string padded with blanks, if I en is more than actual field size; 


Specify Character Highlights Within a Field 
ASCHLT Format: X+(423,fid,len) hits 
Result: rv '! 
fid -the number of the field to be modified; 
len -the length of highlight string; 
hits -character string that defines new highlights for each character position of the field (starting 
from top left corner); each character of Alt s must be one of the following: 
blank - inherit the highlighting set by ASFHLT: 
l - blinking (emulates by dispalying field content in bright yellow on red); 
2 - reverse (background color on neutral color - see "-11" call); 
4 - underscore; 
The field will be changed in the GDDME window during next ASREAD call. FSFRCE request can be used 
to make changes visible immediately. 
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Specify Field Contents 
ASCPUT Format: X+(424,fid,len) chrs 
Result: rv '!' 
fid -the number of the field to be modified; 
len -the length of character string; 
chrs - character string to be placed in the field; each character may pass through an output 
translation (see ASFTRN); if len is less than the total number of characters that can be 
accommodated in the field, the field will be padded with blanks. 
The field will be changed in the GDDME window during next ASREAD call. FSFRCE request can be used 
to make changes visible immediately. 


Specify Symbol Sets Within a Field 
ASCSS Format: X+(425,fid,len) ss 
Result: rv '!' 
fid -the number of the field to be modified; 
len -the length of symbol sets string; 
ss - character string having length len. 
The syntax of this request is checked, but no actions take place. 


Define a Single Field 
ASDFLD Format: X+(401,fid,row,col,dep,wid,typ) '' 
Result: rv '! 
fid -the number of the field; this number must be a positive integer; any existing field of the 
same field number is deleted; 
row -the row for the top left corner of the field; rows are numbered from top to bottom down the 
page, starting with 1. Zero indicates that the field is to be deleted, all subsequent parameters 
are ignored. 
col - the column for the top left corner of the field; columns are numbered from left to right 
across the page, starting with 1. Zero indicates that the field is to be deleted, all subsequent 
parameters are ignored. 
dep -the number of rows that the field occupies. This must be such that the field does not extend 
beyond the bottom of page. Zero indicates that the field is to be deleted, all subsequent 
parameters for this field definition are ignored. 
wid - the number of columns that the field occupies. This must be such that the field does not 
extend beyond the right edge of page. Zero indicates that the field is to be deleted, all 
subsequent parameters for this field definition are ignored. 
typ  - specify the type of field; the following values are valid: 
0 - unprotected alphanumeric (default); 
1 - alphanumeric output, numeric input; 
2 - protected alphanumeric; 
3 - protected alphanumeric, immediate mouse interraptable; 
The new field will appear in the GDDME window during next ASREAD call. FSFRCE request can be used 
to make changes visible immediately. 
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Set Default Field Attributes 


ASDFLT Format: X+(406,cnt ,array) '' 
Result: rv '!' 
® cnt -the number of elements in array. This must be between 1 and 9. 
array -thiscontents cnt values. The following represents the maximum set: 
1. Type - see ASFTYP 
2. Intensity - see ASFINT 
3. Color - see ASFCOL 
4. Symbol Set -ignored 
5. Highlight - see ASFHLT 
6. End - ignored 
7. Nulls - ignored 
8. Blanks - ignored 


9. Table Number - see ASFTRN 


This request sets the default attributes to be assumed for new fields definitions for the current page. These 
values will be used instead of GDDME defaults. 


Define Alphanumeric Fields, Deleting All Existing Fields 


ASDFMT Format: X+(402,n,cnt , array) '' 
Result: rv '! 
n - the number of fields to be defined, this may be zero; 
cnt -the number of elements in array; this must be between 5 and 14; 


array - this contents nxcnt values; each cnt values are used for the definition of the new field; 
the following shows how elements from array are treated: 
1. Field Id 
The number of the field. Zero indicates no field definition; subsequent 
elements are ignored. 





2. Row | 
The row for the top left corner of the field (origin 1). Zero indicates no 
field definition; subsequent elements are ignored. 
3. Column 
The column for the top left corner of the field (origin 1). Zero indicates no 
field definition; subsequent elements are ignored. 
4. Depth 
The number of rows that the field occupies. Zero indicates no field 
definition; subsequent elements are ignored. 
5. Width 
The number of columns that the field occupies. Zero indicates no field 
definition; subsequent elements are ignored. 


6. Type - See ASFTYP 
7. Intensity - See ASFINT 
8. Color - See ASFCOL 


9. Symbol Set -Ignored 
10. Highlight - See ASFHLT 


11. End - Ignored 
12. Nulls - Ignored 
13. Blanks - Ignored 


14. Table Number - See ASF TRN 
Defines alphanumeric fields for the current page. All existing fields are deleted. The fields will appear in the 
window during next ASREAD call. FSFRCE request can be used to make changes visible immediately. 
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Clear Fields 
ASFCLR Format: X+(404,code) '! 
Result: rv '! 
code -the operation required; this may be: 
0 - clear all unprotected fields within the current page (blanks and default attributes 
are used); 

1 - clear all protected fields; 

2 - both of the above; 
Fields will disappear in the GDDME window during next ASREAD call. FSFRCE request can be used to 
make changes visible immediately. 


Define Field Color 
ASFCOL Format: X+(407 ,fid,color) '!' 
Result: rv '! 
fid -the number of the field to be modified; 
color - specifies the new color for the field: 
-1 - leave the color as it is; 
0 - default (7 or set by ASDFLT); 
1 - blue; 
2 - red; 
3 - pink; 
4 - green; 
5 - turquoise; 
6 - yellow; 
7 - neutral (see description of "-11" call); 
The field will be changed in the GDDME window during next ASREAD call. FSFRCE request can be used 
to make changes visible immediately. 


Position the Cursor 


ASFCUR Format: X+(430,fid,row,col) !'!' 
Result: rv '!' 
fid -0 or the field number; 
row,col - new position of character cursor within field (if fid specifies a field) or on the 
current page; 


This position will be used as the initial cursor position during following ASREAD call. 


Define Field Highlighting 
ASFHLT Format: X+(409,fid,hlt) '' 
Result: rv '! 
fid -the number of the field to be modified; 
Alt -specifies the new highlighting for the field: 
-1 - leave the highlighting as it is; 
0 - normal (default); 
1 - blinking (presented as bright yellow on red); 
2 - reversed colors (background color on neutral color - see "-11" call); 
4 - underscore; 
The field will be changed in the GDDME window during next ASREAD call. FSFRCE request can be used to 
make changes visible immediately. 
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Define Field Intensity 
ASFINT Format: X+(411,fid,lnt) '' 
Result: rv '!' 
fid -the number of the field to be modified; 
int -specifies the new intensity for the field: 
-1 - leave the intensity as it is; 
0 - invisible; 
1 - normal (default); 
2 - bright; | 

The field will be changed in the GDDME window during next ASREAD call. FSFRCE request can be used to 
make changes visible immediately. 


Change Field Status 
ASFMOD Format: X+(412,fid,mod) '' 
Result: rv '!' 
fid -the number of the field to be modified; if this parameter is zero, all of the unprotected 
fields (type 0 and 1) are affected; 
mod  -specifies the new status for the field(s): 
0 - make field(s) unmodified; 
1 - make field(s) modified; 
The numbers of modified fields will be returned as the result of ASQMOD call. A field also can become 
modified during ASREAD call as the result of an operator actions. 


Define Symbol Set for a Field 
ASFPSS Format: X¥+(414,fid,ssid) '' 
Result: rv '!' 
fid -the number of the field to be modified; 
ssid -symbol set id: | 
This request ignored. 


Assign Translation for a Field 
ASFTRN Format: X+(415,fid,tbno) '' 
Result: rv '' 
fid -the number of the field to be modified; 
tbno - specifies the new translation for the field: 
-] - leave the translation as it is; 
0 - no translation (default); 
I - uppercase translation; 


Define Field Type 
ASFTYP Format: X+(416,fid,typ) '' 
Result: rv '"'" 
fid -the number of the field to be modified; 
typ -specifies the new type for the field: 
-] - leave the field type as it is; 
0 - unprotected alphanumeric (default); 
1 - alphanumeric output, numeric input; 
2 - protected alphanumeric; 
3 - protected alphanumeric, immediate mouse interruptable; the mouse click in 
such field causes the interrupt of the ASREAD call with the attention code 2. 
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Define The Operator Reply Mode 

ASMODE Format: X+(426,mode) '!' 
Result: rv '!' 

This request is ignored. 


Query Character Colors for a Field 
ASQCOL Format: X+(427,fid,len) '' 
Result: rv clrs 
fid -the number of the field to be queried; 
len -the number of attributes to be returned (this may be zero); this number of characters will be 
returned, regardless of the size of the field (padded with default field's color, if necessary); 
cirs -character string; each element shows the color of field characters, as for ASCCOL; 


Query Character Cursor Position 


ASQCUR Format: X+(431,code) !'! 
Result: (rv,fid,row,col) '' 
code - must be one of the following: 


0 - return page coordinates; 
l- return field coordinates (relatively top left corner of the field); if it is not possible, 
page coordinates are returned; 
fid - field number: 
The number of the field, containing the character cursor. If it is not 0, field 
coordinates have been returned. If it is 0, page coordinates have been returned. 
row,col -the position of the cursor within either the field or the current page, depending on the 
value of fid; 


Query Field Attributes 
ASQFLD Format: X¥+(418,code,n,cnt[,array]) '' 
Result: (rv,array) '' 
code -specifies the operation required; see description of n; 
n - a value of zero indicates that no field definitions are to be queried; otherwise, the 
interpretation of n depends on the value of code, as follows: 
code = 0; n is specific field number, whose definition is to be returned in 
array; the first item of X doesn't include the array parameter; 
code = 1; n is the number of fields to be queried; their identification numbers 
must be in the array parameter in the first item of X; 
code = 2; n is the maximum field number; definitions for fields 1 through n will 
be returned in array; the first item of X doesn't include the 
array parameter; 
cnt -the number of elements in array; this must be between 1 and 14; 
array - this contents nxcnt values; each cnt values describe the definition of a field; the 
following shows how elements from array are treated: 


1. Field Id - The number of the field. Zero indicates no field definition; 
subsequent elements are set to zero. 

2. Row - The row for the top left corner of the field (origin 1). 

3. Column - The column for the top left corner of the field (origin 1). 

4. Depth - The number of rows that the field occupies. 

5. Width - The number of columns that the field occupies. 

6. Type - See ASFTYP 

7. Intensity - See ASFINT 
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8. Color - See ASFCOL 
9. Symbol Set - Always zero. 
10. Highlight - See ASFHLT 


11. End - Always zero. 
12. Nulls - Always zero. 
13. Blanks - Always zero. 


14. Table Number - See ASFTRN 


Query Character Highlights for a Field 
ASQHLT Format: X+(428,fid,len) '"! 
Result: rv hlts 
fid -the number of the field to be queried; 
len -the number of attributes to be returned (this may be zero); this number of characters will be 
returned, regardless of the size of the field (will be padded with default value, if 


necessary); 
Alts - character string; each element shows the highlights of field characters, as for ASCHLT; 


Query the Number of Fields 


ASQMAX Format: X+(,419) '! 
Result: (rv,n,maxn) '' 
n - the number of fields currently defined; 


maxn -the maximum field number currently defined; if there are no fields currently defined, this 
value will be zero; 


Query Modified Fields 
ASQMOD Format: X+(420,cnt) '' 
Result! (rv,fid,len,ilen) '' 
cnt -the number of fields to be queried; 


fid -anarray of modified field numbers; these numbers are returned in the following order: 

1. Modified mouse fields (type 3). 

2. Any other modified fields. 

3. Zero for all other entries. 

Within these categories fields are returned in order of field numbers. 
len -an array of the lengths of corresponding fields from fid array; 
ilen -an array of the lengths of corresponding fields from fid array, excluding trailing blanks 
at the end of fields; 


Query Character Symbol Sets for a Field 
ASQSS Format: X+(429,fid,len) '' 
Result: rv ss 
fid -the number of the field to be queried; 
len -the number of attributes to be returned (this may be zero); this number of characters will be 
returned, regardless of the size of the field (will be padded with default value, if necessary); 
ss - character string; each element of which is blank; 
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Define Field Attributes 





ASRATT Format: X+(417,n,cnt,array) '' 
Result: rv !!' 
® n - the number of fields to be redefined; this may be zero; 
cnt - the number of elements in array; this must be between 5 and 14; 


array -this contents nxcnt values; each cnt values are used for the redefinition of the fields; 
the following shows how elements from array are treated: 


1. Field Id - The number of the field. Zero indicates no field definition; 
subsequent elements are ignored. 

2. Row - Ignored 

3. Column - Ignored 

4. Depth - Ignored 

5. Width - Ignored 

6. Type - See ASFTYP 

7. Intensity - See ASFINT 

8. Color - See ASFCOL 


9. Symbol Set -Ignored 
10. Highlight - See ASFHLT 


11. End - Ignored 
12. Nulls - Ignored 
13. Blanks - Ignored 


14. Table Number - See ASFTRN 
Redefines existing alphanumeric fields for the current page. The fields will be changed in the GDDME 
window during next ASREAD call. FSFRCE request can be used to make changes visible immediately. 





Device Output/Input 
ASREAD Format: X+(,101) '! 
Result: (rv,att,val,cnt) '' 
att  - the type of attention interrupt received; this can be one of the following: 
0 - ENTER key; 


1 - Functional key (or double click on a number between 1 and 24); 
2 - Mouse click (in a field having type 3 only); 
5 - ESC key; 
val -if att =], this is the functional key number , as follows: 
1 -12 - corresponds to Fl - F12 keys; 
13 - 24 - corresponds to Shift/F1 - Shift/F12 keys; 
cnt -the number of modified fields after execution of this function. 
Performs all outstanding output. Allows to input data from keybord and to change character cursor position. 
Waits for attention interrupt. It is possible to use the following to perform service operations: 


TAB - moves cursor to the beginning of the next unprotected field (if any); 

SHIFT/TAB - moves cursor to the beginning of the previous unprotected field (if any); 

INS - set insert/replace input mode (replace is default); 

HOME - moves cursor to the beginning of the current line of the current field; 

CTRL/HOME - moves cursor either to the beginning of the current field or to the beginning of the 
page, 

END - moves cursor to the end of the current line of the current field; 

CTRL/END - moves cursor either to the end of the current field or to the end of the page; 

BS - deletes previous character (if any) in the current field; 

DEL - deletes current character (if any) in the current field; 

LEFT - moves cursor to one character position left; 

RIGHT - moves cursor to one character position right; 

UP - moves cursor to one character position up; 
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DOWN - moves cursor to one character position top; 

L-MOUSE  - either sets cursor at the position of mouse cursor or causes interrupt, if the mouse click 
takes place whithin a field having type 3; in last case the field becomes modified: 

R-MOUSE -the same as L-MOUSE; 

DOUBLE CLK - if a user double clicks a number located in any field displayed on the current page, and if 
this number is a valid integer between 1 and 24, the ASREAD call will be interrupted as a 
user pressed functional key with corresponding number. If SHIFT key is depressed at this 


moment, the attention value will be increased by 12 (the attention value can be between 1 
and 24 only). 


Define Alphanumeric Fields Without Deleting Existing Fields 


ASREMT Format: X+(405,n,cnt,array) '' 
Result: rv '' 
n - the number of fields to be defined; this may be zero; 


cnt -the number of elements in array; this must be between 5 and 14; 
array -this contents nxcnt values; each cnt values are used for the definition of the new field; 
the following shows how elements from array are treated: 


1. Field Id The number of the field. Zero indicates no field definition; 
subsequent elements are ignored. If there exist field having the 
same number, this field will be deleted first. 

2. Row The row for the top left corner of the field (origin 1). Zero 
indicates no field definition; subsequent elements are ignored. 

3. Column The column for the top left corner of the field (origin 1). Zero 

| indicates no field definition; subsequent elements are ignored. 

4. Depth The number of rows that the field occupies. Zero indicates no 


field definition; subsequent elements are ignored. 

5. Width The number of columns that the field occupies. Zero indicates no 
field definition; subsequent elements are ignored. — 

6. Type See ASFTYP 

7. Intensity See ASFINT 

8. Color See ASFCOL 


9. Symbol Set Ignored 

10. Highlight See ASFHLT 

11. End Ignored 

12. Nulls Ignored 

13. Blanks Ignored 

14. Table Number See ASFTRN 
Defines new alphanumeric fields for the current page whithout deleting existing fields. The fields will appear 
in the GDDME window during next ASREAD call. FSFRCE request can be used to make changes visible 
immediately. 


Override Alphanumeric Character-Code Assignments 


FSALRM Format: X+(111, type) '' 
Result: rv '' 

This request is ignored. 

Sound the Alarm 

FSALRM Format: X+(,109) ! 
Result: rv '' 


Sounds the terminal alarm. 
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Close Printer | 

FSCLS Format: X+(601,0pt) '! 
Result: rv '! 

This request is ignored. 


Copy Current Page To Default Printer 
FSCOPY Format: X+(,602) '!' 
Result: rv "' 
This request is equivalent to the GSCOPY request with parameters 1,100,100. 


Update the Display 
FSFRCE Format: X+(,102) '!' 

Result: rv '! 
Causes all changes of alphanumeric fields that have been made since the last ASREAD call for the current 
page to be reflected on the GDDME window. This call does not change the status of any modified 
alphanumeric fields. 


Initialize 
FSINIT Format: X+(,117) '! 
Result: rv '! 
This request is ignored. 
Open Printer 
FSOPEN Format: X+(604,cnt ,array) dest 
Result: rv !! 
dest -8-character string; 
cnt -the number of elements in array; 
array - array from cnt integers; 
This request is ignored. 
Clear the Current Page 
FSPCLR Format: X+(,301) '! 
Result: rv '!' 


Deletes all alphanumeric fields on the current page. Resets graphics field, viewport, and default page 
attributes to their defaults. Clears the GDDME window including graphics. 
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Create a Page 
FSPCRT Format: X+(302,pid,depth,width,type) '' 
Result: rv '' 
pid -the unique identification of the new page; must be positive integer; 0 is reserved as a page 
id of default page, that is always available; 
dept h - integer depth of the GDDME window in character lines; if it is zero, the default value will 
be used; the default number of lines can be set as command string parameter when 
GDDME is loaded (see section 1), otherwise the value 25 will be used; 
width - integer width of the GDDME window in character columns; if it is zero, the default value 
will be used; the default number of columns can be set as command string parameter when 
GDDME is loaded (see section 1), otherwise the value 80 will be used; 
type -integer (ignored). 
This command creates a new GDDME page. The content of the previous current page becomes invisible. 
GDDME will try to use currently selected hardware font (see description of "-12" call) and will resize (if 
necessary) its window according to dept Å and width parameters. However, if the current font does not 
allow to accommodate specified number of rows and columns, GDDME will use smaller font and/or resize its 
window. When a user resizes GDDME window using mouse, changes the number of lines or columns using 
FSPWIN call, or selects another hardware font using "-12" call, GDDME always keeps specified number of 
rows and columns. It may use smaller font or resize its winow to reach this. 
Different pages are independent and may have different number of rows and columns. GDDME restores 
all parameters of a page, when page is selected using FSPSEL rerquest. 
The new page will have default alphanumeric attributes (see ASDFLT), default graphics field (see 
GSFLD), and vieport (see GSVIEW). However, it will inherit all graphics attributes from the previously 
selected page (graphical font, position, color, pattern, and unfinished GSAREA call, if any). 


Delete a Page 
FSPDEL Format: X+(303,pid) '! 
Result: rv '' 
pid -the identificator of the page to be deleted; this must be positive integer. 
Deletes the page, having identification number pid. If deleted page was the current page, the default page 
(pid = 0) will be used as a current page. Default page cannot be deleted. 


Query Specified Page 
FSPORY Format: X+(304,pid) '! 
Result: (rv,depth,width,type) '' 
pid -page identification number; 
depth - depth of the specified page in character rows; 
width - width of the specified page in character columns; 
type -always 3; 
This request returns the dimensions of the page specified by p id parameter in hardware characters. 


Select a Page 
FSPSEL Format: X+(305,pid) '! 
Result: rv '! 

pid - the identificator of the page to be selected; 
The referenced page becomes the current page. All defined fields become visible. Cursor is placed to the 
position that was set by the last ASREAD or ASFCUR call for this page. Definitions of the graphics field and 
the vieport will be restored. The content of the graphics field will be displayed. All following calls will be 
implicitly applied to this page. Only one page can be selected at any time. GDDME also will restore the 
position and dimensions of the window accordingly to their values existed at the moment when this page was 
replaced by another current page. 
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Set Page Window 
FSPWIN Format: X+(309,n1,n2,rows,clms) '' 
Result: rv '' 
n1,n2 -integers which are ignored; 
rows - new depth of the currently selected page in character rows (integer between 2 and 64 or 0); 
if this parameter is 0, the default value of lines will be used; the default value is 25, if it was 
not changed when GDDME was loaded using the "r" command line parameter; 
cols - new width of the currently selected page in character columns (integer between 2 and 132 
or 0); if this parameter is 0, the default value of lines will be used; the default value is 80, if 
it was not changed when GDDME was loaded using the "c" command line parameter; 
This request changes the dimensions of the current page in character lines and columns. GDDME will try to 
use the currently selected hardware font and resize its window to satisfy this request. If it is not possible, 
GDDME will use a smaller hardware font. All alphanumeric fields and the content of the graphics field will 
be deleted. All page attributes, graphics field, graphics window, and viewport will be set to thier defaults. 


Query Current Page Id 
FSQCPG Format: X+(,306) '! 
Result: (rv,pid) '' 
pid -the identifier for the current page; 


Query Device Characteristics 
FSQDEV Format: X+(110,cnt) '' 
Result: (rv,array) '' 
cnt - positive integer ; 
array -anarray of cnt integers; if cnt is more than 17, all elements having indexes more than 
17 will be zeros; 

This command returns device dependent information and some parameters of the currently selected page. 
Description of the elements of the return array: | 

1. always 1; 
. always 2; 
number of rows on the current page; 
. number of columns on the current page; 
. current hardware character box depth in pixels; 
current hardware character box width in pixels; 
maxilmal possible depth of GDDME window in pixels; 
maximal possible width of GDDME window in pixels; 
9. always 0; 
10. always 0; 
11. always 0; 
12. number of possible colors; 
13. always 0; 
14. always 1; 
15. always 0; 
16. current width of GDDME window in pixels; 
17. current depth of GDDME window in pixels; 


CIA RW 
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Query Last Error 
FSQERR Format: X+(110,len) '' 
Result: rv '' 
len - integer; 
This command is ignored. 


Query Unique Page Id 
FSQUPG Format: X+(,307) '' 
Result: (rv,pid) '' 
pid -unused page identifier; 
Returns a unique unused page number. The pid will be lowest unused number that is greater than 1000. 


Save Current Page 
FSSAVE Format: X+(,104) name 
Result: rv '' 
name - 8-element character vector ; 
This command is ignored. 


Display Saved Picture 
FSSHOW Format: X+(,105) name 
Result: rv '' 
name -8-element character vector ; 
This command is ignored. 


Draw a Circular Arc 


GSARC Format: X+(521,xc,yc,angle) '' 
Result: rv '!' 
XC - integer x coordinate of center of circle in world coordinates; 
yc - integer x coordinate of center of circle in world coordinates; 


angle -integer angle subtended by arc in degrees; 
Draws a circular arc from the current point, using the current color, line width, and line type. A positive 
angle is drawn counterclockwise. A negative angle is drawn in the opposite direction. If this call takes 
place between GSAREA and GSENDA calls, this command fills the arc using the current filling pattern and 
color. The current point is moved to the end of the arc. 


Start a Shaded Area 
GSAREA Format: X+(522,mode) '' 
Result: rv '!' 
mode -0 (means do not draw boundary lines) or 1 (means draw boundary lines); 
This command begins construction of a shaded area. After using this command, the following line drawing 
commands are used to define the area to be filled: 


GSARC GSIW 

GSELPS GSMOVE 
GSLINE GSPLNE 
GSLT GSVECM 


The construction is terminated by GSENDA call; 
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Set Current Character Angle 


GSCA Format: X+(510,dx,dy) '' 
Result: rv '!' 
dx - floating point separation in the X direction of the baseline in world coordinates; 
dy - floating point separation in the Y direction of the baseline in world coordinates; 


This command determines the angle of the baseline for drawing characters in graphics operations. 


Set Character Box Size 
GSCB Format: X+(511,wid,hgt) '' 
Result: rv '! 
wid - integer width of character box in world coordinates; 
hgt -integer height of character box in world coordinates; 
This commands sets the size of the font used for graphics operations. The actual size of characters may not 
exactly match these parameters. To determine the actual size of characters, use the GSQCB call. 


Draw Character String At Current Position 


GSCHAP Format: X+(523,len) chrs 
Result: rv '!' 
len -number of characters in chrs; 


chrs - characters to be drawn: 
This command draws the string at the current position using the current font, color, and baseline direction. 
Each character in the string is drawn with its lower left corner at the current position, and the current position 
is then advanced to the starting position of the next character. 


Draw Character String At a Specified Point 


GSCHAR Format: X+(524,x,y, len) chrs 
Result: rv '! 
X - x coordinate of starting point in world coordinates; 
y - y coordinate of starting point in world coordinates; 
len -number of characters in chrs; 


chrs - characters to be drawn; 
This command draws the character string chrs starting at the position indicated by the x and y 
parameters. See also the description of the GSCHAP command. 


Clear The Graphics Field 
GSCLR Format: X+(,506) '! 
Result: rv '' 
This command clears the graphics field. All existing alphanumeric fields still exist. 


Set Current Character Mode 
GSCM Format: X+(513,n) '!' 
Result: rv '!' 
n - integer; 
This command is ignored. 
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Set Current Color 


GSCOL Format: X+(514,n) '' 
Result: rv '' 
n - integer color number from 0 to 15: 
0 - background color; 8 - bright background color; 
1 - blue; 9 -bright blue; 
2 - red; 10 - bright red; 
3 - pink; 11 - violet; 
4 - green; 12 - bright green; 
5 - turquoise; 13 - bright turquoise; 
6 - yellow; 14 - bright yellow; 
7 - neutral color; 15 - bright neutral color; 


This command sets the current color for drawing lines, filling pattern, and characters. The color of filling 
pattern can be also defined using GSPAT request. If there was no GSCOL issued the neutral color will be 
used. | 


Copy the Contents of GDDME Window to Printer 
GSCOPY Format: X+(605,mode,dep,wid) '' 
Result: rv '!' 
mode - defines the way how printer should be selected: 
0 - printing dialog box is displayed that allows to change printer and printing mode; 
1 - output goes to the current default printer; 
dep  - integer vertical dimension in percent of paper size of printer; 
wid -integer horizontal dimension in percent of paper size of printer; 
This command produces a hard copy of the GDDME window. Depth and width indicate what portion of the 
paper to print on. When scaling the image, the aspect ratio of the picture is retained. When the printing is 
invoked from GDDME window's system menu, it is equivalent to the use of GSCOPY 0 100 100 call. 


Set Current Symbol Set 
GSCS Format: X+(515,5s) '! 
Result: rv '!' 
ss - integer; 
This command is ignored. 
Draw an Elliptic Arc 
GSELPS Format: X+(551,type,p,q,xs,ys,xe,ye) '' 
Result: rv '! 
type -integer between 0 and 3, specifying figure type, as follows: 
0 - ellipse; 2 - chord; 
1 - arc; 3 - pie; 
p - integer x axis length of ellipse; 
q - integer y axis length of ellipse; 


XS ,ys - integer coordinates of starting point; 

xe, ye - integer coordinates of end point; 
This command draws an ellipse, arc, chord, or pie slice. The current point is used as the center point of the 
ellipse. If the type parameter is 0, a full ellipse is drawn and xs, ys, xe, and ye are ignored. For other 
values of type, a part of the ellipse is drawn. In that case, xs, ys, xe, and ye define the starting and ending 
points of the figure. The starting and ending points do not need to be on the ellipse. A line drawn from the 
center to the starting and ending points determines the limits of the figure. If this call takes place between 
GSAREA and GSENDA calls, the figure will be filled with the current fill pattern. 
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End a Shaded Area 
GSENDA Format: X+(,525) '! 

Result: rv ''! 
This command terminates the construction of shaded areas. If necessary, a final line is constructed from the 
current point to the beginning of the figure to close the area. The current point does not change unless the final 
line needs to be constructed. See also the description of GSAREA. 


Define a Graphics Field 
GSFLD Format: X+(502,row,col,dep,wid) '' 
Result: rv '' 
row,col - define the location (row and column) of the upper left corner of the graphics field on 
the current page; 


dep,wid -define depth (in rows) and width (in columns) of the graphics field; 
This command redefines the graphics field for the current page. By default, the graphics field covers the 
entire page. At any time exactly one graphics field exists on any page. If any of above parameters is zero, the 
default graphics field will be created. The definitions of the viewport and the window are not affected by this 
call. 


Draw a Straight Line 
GSLINE Format: X+(526,x,y) '' 
Result: rv '' 
X,Y -integer coordinates of the end point of line; 


Draws a line from the current point to the point specified by the parameters x and y. The end of the line 
becomes the new current point. 


Set Current Line Type 
GSLT Format: X+(516,type) '' 
Result: rv '! 
type -integer between 0 and 5 that specifies the line type: 

0 - solid; 
1 - dash; 
2 - dot; 
3 - dash-dot; 


4 - dash-dot-dot; 
5 - null (invisible line); 
6 - inside frame; 
This command sets the line type used by all line drawing commands. 


Set Current Line Width 
GSLW | Format: X+(517, width) "! 
Result: rv '' 
width -integer between 0 and 10 that specifies the line width in world coordinates units; 
This command sets the line width used by all line drawing commands. 
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Set Current Color-Mixing Mode 
GSMIX Format: X+(518,mode) '' 
Result: rv '' 
mode -integer between 0 and 3: 

0 - default, same as 2; 
1 - "mix" mode; 
2 - "overpaint" mode; 
3 - "underpaint" mode; 

This command sets the current color mixing mode. 


Move Without Drawing 
GSMOVE Format: X+(528,x,y) '' 
Result: rv '!' 
X,Y - integer coordinates of new current point (in world coordinates); 


This command moves the current point to the new location without performing any drawing functions. 
However, if it takes place between GSAREA and GSENDA calls, it causes the current figure to be closed (if 
necessary) and a new figure to begin at the new current point. 


Set Current Shading Pattern 
GSPAT Format: X+(520,n) '! 
Result: rv '!' 
n - integer between 0 and 31 that specifies the new shading pattern type. 


The value of n selects one of 32 GDDME filling patterns. This command specifies the shape of a pattern. Its 
color is set by GSCOL command. Pattern's color and shape can be specified in any order. 

n=0 selects solid pattern of current color (set by GSCOL), and n=15 selects solid pattern of background 
color. See the PATTERNS function from GDDME workspace for pattern's samples. 


Draw a Series of Lines 


GSPLNE Format: X+(530,cnt ,xarr,yarr) '' 
Result: rv '!' 
cnt -thelengthof xarr and yarr vectors; 


xarr -an array of x coordinates; 

yarr -an array of y coordinates; 
This command draws a series of straight lines starting at the current point and passing through the vector of 
points specified. The mth line is constructed by drawing a line from the current point to the point given by the 
nth member of xarr and yarr. 
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Query Character Angle 


GSQCA Format: X+(,532) '!' 
Result: (rv,dx,dy) '' 
dx - integer separation in the X direction of the baseline in world coordinates; 
dy - integer separation in the Y direction of the baseline in world coordinates; 


This command returns two integer numbers between -1000 and 1000 to calculate the current character 
baseline angle. 


Query Character Box Size 
GSQCB Format: X+(,533) ''! 
Result: (rv,wid,hgt) '' 
wid - width of the current graphical font in world coordinates units; 
hgt -hight of the current graphical font in world coordinates units; 
This command returns the current dimensions of the graphical font character box size in world coordinates 
units. 


Query Hardware Cell Size 
GSQCEL Format: X+(,535) '! 
Result: (rv,width,height) '' 
width - width of the characters of the font that is used for alphanumeric feilds operations; 
height - height of the characters of the font that is used for alphanumeric feilds operations; 
The dimensions of the font are returned in world coordinates (according to the definitions of the graphics feild, 
the window, and the viewport). The dimensions of graphics font can be obtained through the GSCB call. 


Query the Current Color 
GSQCOL Format: X+(,538) !'!' 
Result: (rv,n) '! 
n - current color that is used for graphical operations (integer between 0 and 15); 


This request returns the current color as it was defined by the GSCOL call. 


Query the Current Position 
GSQCP Format: X+(,539) '! 
Result: (rv,x,y) '' 
X,y -coordinates of the current point in world coordinates units; 


This command returns the coordinates of current point in world coordinates units. 


Query the Graphical Cursor Position 
GSQCUR Format: X+(,541) '! 
Result: (rv,inwin,x,y) '' 
= inwin - shows whether the current cursor position is inside the graphics window or not: 
0 - position returned is outside the window; 
1 - position returned is inside the window; 
X.Y -coordinates of the graphical cursor in world coordinates units; 
This command returns the current coordinates of the graphical cursor in world coordinates units. The 
graphical cursor is set by the GSREAD call. 
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Query the Current Line Type 
GSQLT Format: X+(,542) '! 
Result: (rv,n) '' 
n - current line type as it is defined for GSLT; 


Query the Current Line Width 
GSQLW Format: X+(,543) '! 
Result: (rv,n) '' 
n - current line width world coordinates units; 


Query the Number of Segments 
GSQMAX Format: X+(,544) !! 
Result: (rv,1,1) '' 
This command returns a two element integer vector 1 1 for compatibility purposes. 


Query the Current Color-Mixing Mode 


GSQMIX Format: X+(,545) !! 
Result: (rv,n) '!' 
n - current color-mixing mode as it is defined for GSMIX; 


Query the Current Shading Pattern 


GSQPAT Format: X+(,547) '! 
Result: (rv,n) '!' 
n - current shading pattern type, as it is defined for GSPAT; 


Query the Picture Space Definition 
GSQPS Format: X+(,548) '! 
Result: (rv,wid,hgt) '' 

wid -width of the graphics feild in pixels; 

hgt -height of the graphics feild in pixels; 
This command returns the dimensions of the graphics fieild in pixels. The graphics field is defined by the 
GSFLD call in terms of rows and columns. By default, the graphics field has dimensions 100 by 100 logical 
units regardless of its physical dimensions. For better graphics performance, it is recommended to set the 
logical coordinate system according to the result of the GSQPS. 


Query the Text Box 
GSQTB Format: X+(560,len,cnt) chrs 
Result: (rv,array) '' 
len -lengthof cArs string; 
cnt -number of elements to be returned in array; this must be between 0 and 5; 
array - definition of boundary rectangle; 
This command returns the relative coordinates of the four corners of the text box that fits the string, as a cnt- 
element vector, as follows: 
arrayl1i] -0; 
arrayl2] -0; 
arrayl[l3] - width; 
array({4] - height; 
arrayl5] - undefined; 
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Query the Current Viewport Definition 
GSQVIE Format: X+(,549) '!' 
Result: (rv,x1,x2,y1,y2) '' 
X1 , X2 - left and right boundaries of the current viewport as it is defined for GSVIEW; 
y1,y2 -lower and upper boundaries of the current viewport as it is defined for GSVIEW; 
The values returned will be integers between 0 and 100. 





Query the Current Window Definition 
GSQWIN Format: X+(,550) '! 
Result: (rv,x1,x2,y1,y2) '' 
X1 , X2 - left and right boundaries of the current window as it is defined for GSWIN; 
y1, y 2 -lower and upper boundaries of the current window as it is defined for GSWIN; 


Graphics Input 
GSREAD Format: X+(120,xs,ys) '' 
Result: (rv,att,xt,yt) '' 
XS ,yS - initial position of the graphical cursor in world coordinates; 
xt , Yt - position of the graphical cursor upon the terminating of GSREAD call; 
att - attention code that shows which action caused the termination of this function: 
0 - ENTER key; 
-1 - left mouse button; 
-2 - right mouse button; 
-3 - ESC key; 
1 to 24 - function key number (use SHIFT for key numbers greater than 12); 
This command causes focus to be passed to the GDDME window. The Windows cursor is set to (xs, YS) 
point of the window. The cursor may be moved using the mouse or cursor movement keys. This call terminates 
when you press ENTER, ESC, a function key, or click the left or right mouse button. The return value is a 3 
element integer vector indicating the reason for termination of the input state and the cursor position at this 
moment. Normally, pressing a cursor movement key causes the graphical cursor to move 5 pixels. The use of 
the SHIFT key reduces this distance to 1 pixel. 





Modify Segment Attributes 

GSSATS Format: X+(580,n1,n2,n3) '' 
Result: rv '' 

ni,n2,n3 - integers; 

This command is ignored. 

Close the Current Segment 

GSSCLS Format: X+(,507) ''! 
Result: rv '!' 

This command is ignored. 

Delete a Segment 

GSSDEL Format: X+(508,n) '' 
Result: rv '!' 


n - integer; 
This command is ignored. 
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Create a Segment 
GSSEG Format: X+(509,n) '' 
Result: rv '' 
n - integer; 
This command is ignored. 


Set Segment Position 
GSSPOS Format: X+(582,n1,n2,n3) '' 
Result: rv '! 
ni,n2,n3 - integers; 
- This command is ignored. 
Vectors 
GSVECM Format: X+(531,n,vec) '' 
Result: rv '' 
n - specifies the total number of lines or moves to be performed; 
vec - integer vector length nx 3; 


This command performs a series of line draws or moves from the current point to a new point. Each set of 3 
numbers in vec consists of: 

control, x, y 
control = 0 performs a move to (x, y); control = 1 performs a line to (x, y). The current point is moved to the 
point (x,y) after each operation. 


Define a Viewport 
GSVIEW Format: X+(504,x1,x2,y1,y2) '' 
Result: rv '' 

X1 , X2 -integers between 0 and 100; x1 must be less than x2; 

y1,y2 -integers between 0 and 100; y1 must be less than y 2; 
This command explicitly sets a viewport - the space where graphics output takes place. By default, the 
viewport definition is (0 100 0 100). This means that the viewport takes up the whole graphics field. This call 
allows you to select a part of the graphics field that should be used for graphics. For example, GSVIEW 0 50 
0 50 selects the left lower quadrant of the graphics field for graphics operations. Viewport redefinition does 
not affect the picture that has been already drawn in the graphics field. 


Define a Window 
GSWIN Format: X+(505,x1,x2,y1,y2) '' 
Result: rv '!' 

X1 , X2 - different integers; left and right boundaries of the viewport in logical coordinates; 

y1,y2 - different integers; lower and upper boundaries of the vieport in logical coordinates; 
This command sets the world coordinate system. The default coordinate system has the origin at the left 
bottom corner of the viewport, and the upper right corner has coordinates (100,100). After this call x1 will be 
mapped at left edge of the viewport, and x2 will be mapped at the right edge of the viewport. y1 and y2 will 
be mapped at the lower and upper edges of the viewport. All graphics primitives will use this logical 
coordinate system until a new one is defined. 
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